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CHAPTER 1 


INSTALLATION PROCEDURE 


This chapter describes the procedure for installing BASIC-PLUS-2 V2.2 
on RSX-11M/M-PLUS systems. 


The BASIC-PLUS-2 compiler can be installed by any system user who has 
access to ae privileged account. Compiler installation, however, is 
usually performed by a system manager. 

Prior to installing this version of BASIC-PLUS-2, you must: 


1. Make sure your system meets the minimum software and hardware 
requirements for BASIC-PLUS-2. 


2. Read this manual and decide which options you want to choose 
for your compiler and environment. 


3. Where necessary, create partitions for the secondary cache 
and resident libraries, if you want those options. 


1.1 SOFTWARE AND HARDWARE REQUIREMENTS 


The minimum operating system requirement for BASIC-PLUS-2 V2.2 is one 
of the following: 


@ RSX-11M V4.1 
@ RSX-11M-PLUS V2.1 

The minimum file system requirement for BASIC-PLUS-2 V2.2 is: 
e@ RMS-11 V2.0 


The minimum system configuration requirements for BASIC-PLUS-2 V2.2 
are: 


@ Any mapped RSX-11M V4.1 or RSX-11M-PLUS v2.1 system 
configuration, as defined in the current RSX-11M Software 
Product Description or RSX-11M-PLUS Software Product 
Description 


@ 32K words of virtual address space (in addition to the RSX-11M 
or RSX-11M-PLUS Executive) for the BASIC-PLUS-2 task image 


e@ Any terminal with a half-duplex or a full-duplex driver 
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The following amounts of disk space: 


- 945 contiguous blocks for the BASIC-PLUS-2 compiler 


- 155 blocks for the BP2RES memory-resident library, if you 


select this option 


~- 45 contiguous blocks for the BP2SML memory-resident 


library, if you select this option 


- 170 contiguous blocks for the BASIC-PLUS-2 Resequencer, 
you select this option 


if 


- 250 blocks for the BASIC-PLUS-2 object module library with 


the EIS hardware math package 


- 235 blocks for the BASIC-PLUS-2 object module library with 


the FPU hardware math package 


- 310 blocks for the BASIC-PLUS-2 Help file, if you select 


this option 
- 20 blocks for the error message file 
- 10 blocks for the BASIC-PLUS-2 ODL files 


- 240 contiguous blocks for the RUN support task image, 
you select this option 


- 4000 temporary blocks for the installation procedure 
NOTE 
The values for block sizes are approximate. 
The following RSX-11M and RSX-11M-PLUS Executive directives: 
- aASTxs (AST Exit) 
- CMKTS (Cancel Mark Time and Cancel Selective Mark Time) 
- DIRS$ (Directive) 
- EXITS (Exit) 
- EXTKS (Extend Task) 
- EXSTS$ (Exit with Status) 
- GLUNS (Get LUN) 
- GTIMS (Get Time) 
- PLAS (Memory Management for BP2RES) 
- QI0$ (Queue I/O) 
- RPOI$ (Request and Pass Offspring Information) 
- SETFS (Set Event Flag) 


- SVTKS (Specify Vector Table) 


if 
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e The following programs: 


- File Transfer Program (FLX) - to transfer files from a 


magnetic tape (for magnetic tapé distribution only) 


- Peripheral Interchange Program (PIP) - to manipulate 
distribution files 


- Task Builder (TKB) - to link the BASIC-PLUS -—2 
memory-resident libraries, if you select this option 


- Slow Task Builder (STK) - to link the object modules for 
the BASIC-PLUS-2 compiler 


- Librarian (LBR) - to modify object module libraries 


- Object Module Patch Utility (PAT) - to modify object 
modules to support changes in PRINT USING format 
characters, if you select this option 


—- Monitor Console Routine (MCR) - to communicate with the 
operating system 


- MACRO Assembler - to assemble installation files for RUN 
support, if you select this option 


NOTE 


If these programs are present in the system 
UIC account but not installed on your system, 
the installation procedure will install them. 


1.2 BEFORE INSTALLING BASIC-PLUS-2 


Unless you are taking the default installation, you should choose the 
options you want your BASIC-PLUS-2 compiler to have before starting 
the installation. In particular, you must decide whether you want to 
install the optional memory-resident libraries and/or the secondary 
cache. If you choose to install either of these options, you will 
need particular information about your system resources to answer the 
guestions in the installation dialogue properly. The following 
sections discuss these options in detail. 


1.2.1 Choosing Memory-Resident Libraries 


There are two BASIC-PLUS-2 memory-resident libraries, BP2RES and 
BP2SML. You can install one, both, or neither library. Tasks linked 
to a memory-resident library use less disk space than tasks not linked 
to a resident library. Also, two or more tasks linked to a resident 
library can share that library at run-time, reducing the amount of 
physical memory in use. However, due to its size and overlay 
structure, the large memory-resident library BP2RES can noticably 
reduce run-time performance. Therefore BP2RES is recommended only for 
tasks that do not depend on fast execution or that are too large to 
task build without memory-resident library support. Note that the 
smaller library, BP2SML, has no effect on run-time performance. 
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Once you decide to install either or both memory-resident libraries, 
you must select or create a partition for each library to reside in. 
You should do this before installing BASIC-PLUS-2. The large 
memory-resident library, BP2RES, requires a partition that is 17K 
words in size if you use the FPU hardware and a partition that is 20K 
words in size if you use EIS. The smaller library, BP2SML, requires a 
partition that is only 8K words in size using either hardware package. 
For information on how to create a partition, see the RSX-11M/M-PLUS 
DCL Manual or the RSX-11M/M-PLUS MCR Operations Manual. 


Finally, once you have chosen the partition for each library you are 
going to install, write down the partition's name and base address. 
The BASIC-PLUS-2 installation procedure asks you for this information 
as part of the installation dialogue. {If you choose the GEN 
partition on an RSX-11M-PLUS system you need to specify only the name, 
not the base address.) 


1.2.2 Choosing the Secondary Cache 


Another option you can choose during the BASIC-PLUS-2 installation is 
secondary caching. The secondary cache is a work area in memory where 
the compiler stores some of the temporary work files during a 
compilation. (When there is no secondary cache, BASIC stores these 
work files on a physical device.) Storing the work files in memory 
minimizes the amount of disk I/O, thus reducing compilation time. 


You also get to choose the size of the secondary cache. Once 
BASIC-PLUS-2 is installed, the size of the secondary cache is fixed 
and cannot be altered without reinstalling the compiler. Therefore, 


carefully consider the following issues before deciding whether to use 
secondary caching; and if so, what size secondary cache to use. 


@® Very small programs rarely need to access work files since the 
work files can usually fit within the physical memory the 
compiler allocates for itself. Thus the memory assigned to a 

‘secondary cache goes unused, wasting system resources. 


Medium to large size programs do access work files and would 
benefit from secondary caching. In general, the larger the 
program the larger the work files the compiler needs to 
access, and thus, the larger the secondary cache needs to be 
for optimum compiler speed. 


@ A second consideration is the average number of compilations 
run at any one time and the available physical memory on your 
system. If you use a secondary cache, each compilation 
assigns physical memory for both the compiler and a secondary 
cache. That is, each compilation gets a secondary cache. In 
addition, the B22SHR and B22SH1 memory-resident libraries are 
called into memory. (The compiler needs these libraries in 
order to access the secondary cache.) These libraries are 
shared by all current compilations. 


However, if you chose a large secondary cache, it is possible 
that running several compilations concurrently will exhaust 
the system's physical memory. As a result, either: 1) tasks 
will be checkpointed {swapped in and out of memory) 


dramatically slowing down all tasks, including the 
compilation, or 2) the last compilation to start will not find 
enough memory for a secondary cache. In this case, the 


compilation runs without a secondary cache, putting its work 
files on disk. 
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If you decide to install the secondary cache, you must select or 
create partitions for the libraries B22SHR and B22SH1 to reside in. 
Each library requires a partition that is 4K words in size. For 
information on how to create a partition, see the RSX-11M/M-PLUS DCL 
Manual or the RSX-11M/M-PLUS MCR Operations Manual. a 


Write down the partitions' names and base addresses. The BASIC-PLUS-2 
installation procedure asks you for this information as part of the 
installation dialogue. (If you choose the GEN partition on an 
RSX-1L1M-PLUS system you need to specify only the name, not the base 
address.) 


1.3 MOUNTING THE DISTRIBUTION MEDIUM 


Once you are ready to begin the installation procedure, you must mount 
the distribution medium. 


If your distribution medium is magnetic tape, you should: 


1. Create a special privileged account other than [1,1], [1,2], 
or [*,54] to install and maintain BASIC-PLUS-2. 


2. Log into the system, using the special privileged account to 
install BASIC-PLUS-2. 


3. Place the tape on the magnetic tape drive with the write 
enable ring removed. 


Make sure the file write protected indicator light is lit. 
Load the tape according to the instructions for your drive 
and check to see that the load point indicator light is lit. 
Set the ONLINE/OFFLINE switch to ONLINE and make sure the 
ready indicator light is lit. (The names of these indicator 
lights vary from drive to drive.) 


4. Issue the MOUNT command with the FOREIGN qualifier. 


DCL MCR 
MOUNT/ FOREIGN ddnn: MOUNT ddnn:/ FOREIGN 
where: 
ddnn: Is the name and number of the device on which 


the distribution medium is physically mounted. 
If the default density of your tape drive is not the same as 
the density of the distribution medium, you must include the 
/DENS= qualifier to the MOUNT command to specify the correct 
density. 
If your distribution medium is a disk, you should: 


1. Create a special privileged account other than [1,1], [1,2], 
or [*,54] to install and maintain BASIC-PLUS-2. 


2. Log into the system, using the special privileged account for 
installing BASIC-PLUS-2. 


3. Insert the disk in the disk drive. 
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4. Set the disk drive to the RUN position. 


Make sure that the ready light is lit. (The name of this 
indicator light varies from drive to drive.) 


5. Turn on the WRITE PROTECT switch for the disk drive. 


6. Issue the MOUNT command with the label BP2V2: 


DCL . MCR 
MOUNT ddnn: BP2V2 MOUNT ddnn:BP2V2 
where: 
ddnn: Is the name and number of the device on which 


the distribution medium is physically mounted. 


Make sure the logical name LB: is assigned to the device on which 
your system libraries are stored, so that all users can access 
BASIC-PLUS-2 libraries. LB: is used in the installation procedure as 
the logical name for the default device. 


To assign a logical name, use this format of the DCL ASSIGN command or 
MCR ASN command: 


DCL MCR 
ASSIGN ddnn: LB: ASN ddnn:=LB: 
where: 
ddnn: Is the name and number of the device where the system 


libraries are stored. 


You can also use a logical name to specify a device throughout the 
installation. 


1.4 INSTALLING BASIC-PLUS-2 


The BASIC-PLUS-2 installation procedure consists of two parts that 
must be performed from the MCR command level: the BP2BLD dialogue, 
executed by DIALOG.TSK, and the creation of installation command 
files, executed by BP2BLD.TSK. The BP2BLD dialogue is an interactive 
program that lets you choose options for the BASIC-PLUS-2 V2.2 
compiler. The BP2BLD dialogue asks you questions and places your 
answers in the command file BP2DEF.CMD. The BP2BLD dialogue program 
also creates other installation command files, based on your responses 
to the dialogue, to copy installation files from the distribution 
medium to the temporary storage account you specify in the BP2BLD 
dialogue. 


The installation procedure then performs the following functions: 
e Linking installation files 
@ Executing installation command files 


To run the BP2BLD programs, you must be at the MCR command level. To 
enter MCR from DCL, type: 


SET TERMINAL/MCR 
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Once you are at the MCR command level, copy the BP2RSX.CMD file from 
the distribution medium. If your distribution medium is magnetic 
tape, type: 


FLX SY:/RS=ddnn:[1,10]BP2RSX.CMD/DO 
If your distribution medium is disk, type: 

PIP SY:/NV=ddnn:[1, 10]BP2RSX.CMD 
where: 


ddnn: Is the name and number of the device on which 
the distribution medium is physically mounted. 


Execute the BP2BLD programs by typing: 


@BP2RSX 


1.4.1 The Installation Dialogue 
The BP2BLD dialogue is divided into the following sections: 


1. Installing libraries, the secondary cache, RUN support, the 
BASIC-PLUS-2 Resequencer, and the Help file 


2. Specifying the location for the compiler, the work files, the 
object module library, the BP2 ODL files, and the temporary 
installation files 


3. Specifying whether or not to update the compiler 


4. Specifying whether or not to delete the temporary 
installation files 


5. Specifying whether or not to verify the installation 


For some questions in the dialogue, you must answer either YES or NO. 
If you answer something else, the BP2BLD dialogue responds with the 
message "Please answer "YES" or "No"." 


For several questions in the BP2BLD dialogue, you must choose one of 
several answers. If you answer something other than the allowable 
choices, the BP2BLD dialogue responds with the message "Please answer 
one of the following:", listing the possible answers. 


For several questions in the BP2BLD dialogue, your answer must be a 
certain number of characters. If your answer is more than the maximum 
number of characters, the BP2BLD dialogue responds with the message 
"Your answer must be less than n number of characters in length," 
substituting the maximum number of characters for n. 


For several questions in the BP2BLD dialogue, your answer must be 
within a certain range of values. If your answer is not in the range, 
the BP2BLD dialogue responds with the message “Your answer must be in 
the range from n to n," substituting the allowable range for n. 


For several questions in the BP2BLD dialogue, your answer must be an 
unsigned integer and within a certain range of values. If your answer 
is not an unsigned integer, the BP2BLD dialogue responds with the 
message "Your answer must be an unsigned integer in the range from n 
ton," substituting the allowable range for n. 
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If you want to change an answer during the dialogue, but before the 
summary, you can back up one question at a time by pressing the escape 
key (ESC). However, if you attempt to back up beyond the first 
question, the BP2BLD dialogue responds with the message "This is the 
first question in the BP2BLD dialogue.’ 


If you receive an error message during the installation, consult your 
RSX-11M/M-PLUS operating systems documentation. 


To abort either BP2BLD program, press the CTRL key and the C Key at 
the same time, and then type "ABO AT.". For example: 


MCR 


“e 
MCR>ABO AT. 


This section describes the BP2BLD dialogue and installation procedure. 
The shaded text is the dialogue as it appears on the terminal, and the 
indented text explains how you should answer the questions the BP2BLD 
dialogue contains. The explanations do not appear in the dialogue. 





Enter the name of the device or the logical name for the device 
on which the distribution medium is plea mounted. 
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This starts the BP2BLD aidiogue. othe BP2BLD. Giaiogue: asks. you 

questions so you. can select the options for your BASIC-PLUS~2 
compiler. The default answer for each question. is. in angle 
brackets. To select the default, press the RETURN key. If you . 
donot. want the: default answer, type in the answer yeu want + 








You should. read the BASIC-PLUS-2, intallation guide. before you. 
begin. the BP2BLD dialogue. Some of the answers you select can — 
result in additional: questions. or «the. omission ..of ‘certain 
questions ™ later. in. the «dialogue. If you are not sure how. to 
answer a question, you, can either type a question mark (?) ‘for: a 
brief explanation or see the aerate 2 installation guide: for 
more information. ae pie ee, ohh By aes 


The BP2BLD diatogue, prints. ‘a 2 summary. of your ‘answers ae eho” “end 
UW: PhO. change. your answers, answer YES 





Eb thes auestion runs the: ‘BP2B D dialogue aga 
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Accepting the default installation or default answers installs a 
version of BASIC-PLUS-2 that fits on all systems. However, you 
can improve the performance of BASIC-PLUS-2 if you answer each 
question in the dialogue to customize BASIC-PLUS-2 to your 
system. 
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If you want the default installation, answer YES. The BP2BLD 
dialogue asks the next question and then displays a summary of 
the options for the default installation. 


You can also answer with the file name of an indirect command 
file. Using an indirect command file frees you from having to 
answer each question at the terminal. 


To create an indirect command, use a text editor and create a 
file with the file type CMD. Enter your answer to each question 
in the dialogue on a separate line. A blank line indicates a 
carriage return that selects the default answer for that 
question. To execute your indirect command file, respond to this 
question with: 


@filename.CMD 
where: 
filename Is the name of your indirect command file. 


If you do not want the default installation, answer NO or specify 
the file name of an indirect command file and skip the 
information in this installation guide until you reach the "Do 
you want to install BP2RES" question. 


aren th at 
Oe 





Enter the three-character name you want to use to invoke the 
BASIC-PLUS-2 compiler. This name becomes the first three 
characters of the file names for all BASIC-PLUS-2 components 
except for the following: 


BASIC2.ERR 
BP2.HLP 

BP2RFA.HLP 
B2RESQ. TSK 
B22SHR.TSK 
B22SH1.TSK 


For example, if you choose FPU, the file name for the 
BASIC-PLUS-2 compiler is FPUIC2. 


At this point, if you chose the default installation, the BP2BLD 
dialogue displays a summary of the options for the default 
installation. The summary is written to the file nnnDEF.DOC as a 
record of the installation. Nnn is the three-character name you 
previously chose to invoke the BASIC-PLUS-2 compiler. 
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If you want the default installation, answer NO or press the 
RETURN Key. Then, the BP2BLD dialogue responds with the 
following messages: 





If you chose the default installation, you can now skip’ the 
questions that follow until you reach these same two messages on 
page 1-20 of this manual. 


If you do not want the default installation or you want to change 
one of your answers, answer YES to this question. Then the 
BP2BLD program runs the BP2BLD dialogue again. What follows is 


each question in the dialogue and an explanation of how to answer 
each one. 





Do you want the default installation <YES> 





If you answer YES, BASIC-PLUS-2 is installed with the defauit 
options. Answer NO or specify an indirect command file if you 
want to customize BASIC-PLUS-2 to your system. 





There are two BASIC-PLUS-2 memory-resident libraries: BP2RES and 
BP2SML. You can install none of the BASIC-PLUS-2 memory-resident 
libraries, one of them, or both of them. 


Linking BASIC programs to the memory-resident libraries reduces 
the size of the task image. However, using BP2RES also slows 
down the execution of the task. Therefore, linking to BP2RES is 
only recommended for tasks that are not sensitive to run-time 
performance or that are too large to task build without 
memory-resident library support. See Section 1.2.1 for more 
information on choosing BASIC-PLUS~-2 memory~-resident Libraries. 


If you answer NO or take the default, skip the next three 
questions. If you answer YES, the BP2BLD dialogue asks you the 
next three questions. 
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Enter the name of the device and the account where you want to 
store BP2RES. Select a device that can store approximately 155 
blocks of disk space and an account that is accessible to all 
users. Be sure you have enough space on the disk before 
installing BP2RES. 





i 


eo 


ae 


RSX-11M/M-PLUS systems require you to enter the name of the 
partition where you plan to install BP2RES. Choose a partition 
that can accommodate 20K words if you use an EIS processor, or 
17K words if .you use an FPU processor. The default partition 
name is BP2RES on RSX-11M systems and GEN on RSX-11M-PLUS. 


If you answer with GEN or any other system-controlled partition 
on an RSX-11M-PLUS system, the library is checkpointable. 
Checkpointable tasks swap out of memory when they are not 
required, which helps to conserve system memory. If you specify 
a nonexistent partition, the partition defaults to GEN. 


In addition, if you choose GEN as the partition name on an 
RSX-11M-PLUS system, the BP2BLD dialogue skips the next question. 


On both RSX-11M and RSX-11M-PLUS systems, if you specify an 
existing partition other than the default, the installation 
procedure changes the partition name to match the library name: 
nnnRES, where nnn is the three-character name you choose later in 
the dialogue for invoking BASIC. 





Enter the base address of the partition name you selected for 
BP2RES. You can determine the address by using the DCL SHOW 
PARTITION command or the MCR PARTITION command. See the 
RSX-11M/M-PLUS Command Language Manual for more information on 


the DCL SHOW PARTITION command. See the RSX-11M/M-PLUS MCR 
Operations Manual for more information on the MCR PARTITION 
command. 





NOTE 


You must determine the absolute address of the 
partition before you answer this question. If 
you enter a carriage return or an incorrect 
address, the resident library will not be 
installed correctly. 


The absolute address becomes the physical base address of the SET 
/MAIN=parname command on RSX-11M systems and of the SET /PAR 
command on RSX-11M-PLUS systems. 





BP2SML is a BASIC-PLUS-2 memory-resident library that contains a 
subset of the BASIC-PLUS-2 OTS. It requires 8K words of physical 
memory and 8K words of virtual address space. 
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BP2SML shares the advantages of BP2RES, except that BP2SML 
contains only a subset of the BASIC-PLUS-2 OTS. If you installed 
BP2RES and your site develops commercial applications, you may 
want to install both BASIC-PLUS-2 memory-resident libraries to 
make sure your applications run with each library as expected. 
See Section 1.2.1 for more information on choosing 
memory-resident libraries. 


If you answer YES, the program asks you the next three questions. 
If you answer NO or take the default, skip the next three 
questions. 





Enter the name of the device and the account where you want to 
store BP2SML. Select a device that can store approximately 45 
blocks of disk space and an account that is accessible to all 
users. Be sure you have enough space on the disk before 
installing BP2SML. 





RSX-L1IM/M-PLUS systems require you to enter the name of the 
partition where you plan to install BP2SML. Choose a partition 
that can accommodate 8K words. The default partition name is 
BP2SML on RSX-11M systems and GEN on RSX-11M-PLUS. 


If you answer with GEN or any other system-controlled partition 
on an RSX-11M-PLUS system, the library is checkpointable. 
Checkpointable tasks swap out of memory when they are not 
required, which helps to conserve system memory. If you specify 
a nonexistent partition, the partition defaults to GEN. 


In addition, if you choose GEN as the partition name on an 
RSX-11M-PLUS system, the BP2BLD dialogue skips the next question. 


On both RSX-11M and RSX-11M-PLUS systems, if you specify an 
existing partition other than the default, the installation 
procedure changes the partition name to match the library name: 
nnnSML, where nnn is the three-character name you choose later in 
the dialogue for invoking BASIC. 





is the absolute address for BP 


Enter the base address of the partition name you selected for 
BP2SML. You can determine this address by using the DCL SHOW 
PARTITION command or the MCR PARTITION command. 


NOTE 


You must determine the absolute address of the 
partition before you answer this question. If 
you enter a carriage return or an incorrect 
address, the resident library will not be 
installed correctly. 


The absolute address becomes the physical base address of the SET 
/MAIN=parname command on RSX-11M systems and of the SET /PAR 
command on RSX-11M-PLUS systems. 
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The secondary cache is a section of memory the BASIC compiler 
uses to store work files during a GoOmpilation~.”™ Storing the work 
files in memory reduces the compilation time by reducing the 
number of disk accesses the compiler must make to retrieve its 
work files. See Section 1.2.2 for more information. on 
secondary caching. 


If you answer YES, the BASIC compiler uses secondary caching to 
store the work files in memory when the physical memory is 
available. If you answer NO, the BASIC compiler does not use 
secondary caching, and the work files are stored on a disk during 
compilations. If you answer NO, the dialogue skips the next 
seven questions dealing with secondary caching and its associated 
libraries, B22SHR and B22SH1. 





If you chose to install secondary caching in response to the 
previous question, the dialogue now asks how large you want the 
secondary cache to be. You can make the secondary cache any 
multiple of 4K words from 4K to 60K. Note however that large 
secondary caches waste system resources except when compiling 
extremely large programs. Your choice should be based on the 
average number of simultaneous compilations, the average size of 
the programs, and the amount of free virtual memory on your 
system. 





B22SHR is one of two memory-resident libraries the BASIC compiler 
needs in order to access the secondary cache. Enter the name of 
the device and the account where you want to store B22SHR. 
Select a device that can store approximately 25 blocks of disk 
space and an account that is accessible to all users. 





Enter the name of the partition where you want to install B22SHR. 
You must choose a partition that can accommodate 4K words. The 
default partition name is B22SHR on RSX-11M systems and GEN on 
RSX-11M-PLUS. If you answer with GEN or any other 
system-controlled partition on an RSX-11M-PLUS' system, the 
library is checkpointable. Checkpointable tasks swap out of 
memory when they are not required, which helps to conserve system 
memory. If you specify a nonexistent partition, the partition 
defaults to GEN. 


In addition, if you choose GEN as the partition name on an 
RSX-11M-PLUS system, the BP2BLD dialogue skips the next question. 


On both RSX-11M and RSX-11M-PLUS systems, if you specify an 
existing partition other than the default, the installation 
procedure changes the partition name to match the library name: 
B22SHR. 





Enter the base address of the partition name you selected for 
B22SHR. You can determine the address by using the DCL SHOW 
PARTITION command or the MCR PARTITION command. See the 
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RSX-11M/M-PLUS Command Language Manual for more information on 
the DCL SHOW PARTITION command. See the RSX-11M/M-PLUS MCR 
Operations Manual for more information on the MCR PARTITION 
command. 


NOTE 


You must determine the absolute address of the 
partition before you answer this question. If 
you enter a carriage return or an incorrect 
address, the resident library will not be 
installed correctly. 


The absolute address becomes the physical base address of the SET 
/MAIN=parname command on RSX-11M systems and of the SET /PAR 
command on RSX-11M-PLUS systems. 





‘What 


B22SH1 is the other memory-resident library the BASIC compiler 
uses to access the secondary cache. Enter the name of the device 
and the account where you want to store B22SH1. Select a device 
that can store approximately 25 blocks of disk space and an 
account that is accessible to all users. 





Enter the name of the partition where you want to install B22SH1. 
You must choose a partition that can accommodate 4K words. The 
default partition name is B22SH1 on RSX-11M systems and GEN on 
RSX-11M-PLUS. If you answer with GEN or any other 
system-controlled partition on an RSX-1lIM-PLUS system, the 
library is  checkpointable. Checkpointable tasks swap out of 
memory when they are not required, which helps to conserve system 
memory. If you specify a nonexistent partition, the partition 
defaults to GEN. 


In addition, if you choose GEN as the partition name on an 
RSX-l11M-PLUS system, the BP2BLD dialogue skips the next question. 


On both RSX-11M and RSX-11M-PLUS systems, if you specify an 
existing partition other than the default, the installation 
procedure changes the partition name to match the library name: 
B22SH1. 





Enter the base address of the partition name you selected for 
B22SH1. You can determine the address by using the DCL SHOW 
PARTITION command or the MCR PARTITION command. See the 
RSX-11M/M-PLUS Command Language Manual for more information on 
the DCL SHOW PARTITION command. See the RSX-11M/M-PLUS MCR 
Operations Manual for more information on the MCR PARTITION 
command. 


NOTE 


You must determine the absolute address of the 
partition before you answer this question. If 
you enter a carriage return or an incorrect 
address, the resident library will not be 
installed correctly. 
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The absolute address becomes the physical base address of the SET 
/MAIN=parname command on RSX~11M systems and of the SET /PAR 
command on RSX-11M-PLUS systems. 





If you answer YES, you can execute programs in the BASIC 
environment with the RUN command, access the BASIC-PLUS-2 
debugger in the BASIC environment with the RUN/DEBUG command, 
make object modules available for execution with the LOAD 
command, and execute immediate mode statements. If you answer 
NO, support for these options is not built and the BP2BLD 
dialogue skips the next question. 





ie 


BASIC-PLUS-2 programs can access files on other computer systems 
connected to your computer by DECnet. To provide this remote 
file access support for immediate mode statements and programs 
run in the BASIC environment, the RUN task must be linked to 
libraries that provide RMS-11 DECnet support. If you answer YES 
to this question, support for remote RMS file access is linked to 
the RUN task. If you answer NO, the RUN task is not linked to 
remote file access support. 





If you decided to install BP2RES, you may choose to link the 
support for the RUN command, the LOAD command, and immediate mode 
statements with the BP2RES and RMSRES memory-resident libraries. 
Programs run fastest when using the memory-resident libraries. 
However, the libraries must be stored in the account LB:[1,1] to 
be linked to the support for RUN. If RMSRES is not in LB:[1,1] 
or you chose to store BP2RES in another account, you must answer 
NO to this question. 


Note that in addition to the BP2RES and RMSRES libraries, if you 
decided to include remote RMS support with RUN in the previous 
question, the DAPRES library that supports remote file access 
through DECnet will also be included. DAPRES must also be in 
LB:[1,1]. 


Answer YES to link the support for RUN with the memory-resident 
libraries. Answer NO to link the support for RUN with the 
BASIC-PLUS-2 object module library. 





The Resequencer is a BASIC-PLUS-2 utility that uses approximately 
185 blocks of disk space and allows you to renumber the line 
numbers in your program. 


If you answer YES, the Resequencer file is installed on the 
device and account you specify in the next question. If you 
answer NO or take the default, skip the next question. 
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Enter the name of the device and the account where you want to 
store the BASIC-PLUS-2 Resequencer. Select a device that can 
store approximately 185 blocks of disk space and an account that 
is accessible to all users. Be sure you have enough space on the 


arr 


Gdisk before installing the BASIC-PLUS-2 Resequencer. 





The two BASIC-PLUS-2 Help files use approximately 310 blocks of 
disk space and provide on-line documentation for BASIC-PLUS~2. 
If you answer YES, the Help files are copied from the 
distribution medium to the device and account you specify in the 
next question. If you answer NO or take the default, skip the 
next question. 





“What. name 


Enter the name of the device and the account where you want to 
store the BASIC-PLUS-2 Help files. Select a device that can 
store approximately 310 blocks of disk space and an account that 
is accessible to all users. Be sure you have enough space on the 
disk before installing the BASIC-PLUS-2 Help files. 





Enter the hardware math package you want to use with this version 
of BASIC-PLUS-2. You can specify EIS (Extended Instruction Set) 
or FPU (Floating Point Unit.) If your system has both types of 
math hardware, choose FPU, because it processes floating-point 
arithmetic faster and uses less virtual address space. 





use to invoke BP2 <BP2>_ 





Enter the three-character name you want to use to invoke the 
BASIC-—PLUS-2 compiler. This name becomes the first three 
characters of the file names for many of the BASIC-~PLUS-2 
components. For example, if you choose FPU as the name to 
indicate the hardware math package being used, the file name for 
the BASIC-PLUS-2 compiler is FPUIC2. 





When you are in the BASIC environment, BASIC-PLUS-2 displays a 
prompt that tells you the compiler is ready to execute commands, 
program lines, or immediate mode statements. You can answer with 
any three-character combination of letters and digits. The 
default prompt is used in examples throughout the documentation. 





Enter the name of the device and the account where you want to 
store the BASIC-PLUS-2 compiler. Select a device that can store 
approximately 945 contiguous blocks of disk space and an account 
that is accessible to all users. The device must also have 
approximately 240 free contiguous blocks if you chose to support 
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the RUN command. Be sure you have enough space on the disk 


before installing the BASIC-PLUS-2 compiler. Note that the 
BP2BLD program automatically sets the file protection for the 
compiler. sama ; 





The BASIC-PLUS-2 compiler opens three work files every time it is 
invoked. The first file is an internal representation of your 
program and is approximately the same size in blocks as_ the 
program currently in memory. The second file contains line 
tables and internal code, using approximately 130 blocks of disk 
space. The third file contains symbol tables and cross-reference 
information, if in effect, using approximately 255 blocks of disk 
space. 


Select a device that is not heavily used, has a high transfer 
rate, and, if you have the option, is not on the same disk as the 
BASIC-PLUS-2 compiler. Select an account that is accessible to 
all users. 





Enter the name of the device and the account where you want to 
store the BASIC-PLUS-2 object module library file. If you chose 
EIS hardware, select a device that can store approximately 250 
blocks of disk space. If you chose FPU hardware, select a device 
that can store approximately 235 blocks of disk space. Select an 
account that is accessible to all users. Be sure you have enough 
space on the disk before installing the BASIC-PLUS-2 object 
module library. 





Enter the name of the device and the account where you want to 
store the BASIC-PLUS-2 ODL files. BASIC-PLUS-2 uses these ODL 
files when you add a file organization qualifier to the BASIC 
BUILD command or when your program uses an ORGANIZATION clause in 
an OPEN statement. Select a device that can store approximately 
20 blocks of disk space and an account that is accessible to all 
users. Be sure you have enough space on the disk to install the 
BASIC-PLUS-2 ODL files. 





eo Se 


These files are used for the installation and are temporary. 
During the installation, they are either created or copied from 
the distribution medium to the device and account you specify. 
Select a device that can temporarily store approximately 4000 
blocks of disk space. Be sure you have enough space on the disk 
to accommodate the temporary installation files. 





‘Enter the device ‘an 


Specify the device and account where the RMS-1l1l ODL files reside. 
These files must already be on your system for the BASIC-PLUS~2 
installation to complete properly. 
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In some countries, there are letters following "Z" in the 
alphabet. If you answer YES, the EDITS function code 32 converts 
these lowercase letters to uppercase. 





You can specify AM/PM to use the 12-hour clock (AM and PM format; 
for example: 3:00 PM) or 24 to use the 24-hour clock, (for 
example: 15:00). The format you choose is used as the value for 
the TIME$(0%)} function. 





The dollar sign ($) PRINT USING format character is used for the 
currency symbol in the United States and Canada. If you want to 
specify a symbol other than the default, enter it here and the 
PRINT USING statement will use it when formatting. 





What 


Do you want to update the BP2 compiler <No> 


You can specify another symbol for the decimal point to be used 
by the PRINT USING statement when formatting. If you want to 


specify a symbol other than the default, enter it here. 





do you want as the character. for ‘the PRINT USING 
third digit separator. <,> er : 





You can specify another symbol for the third-digit separator to 
be used by the PRINT USING statement when formatting. If you 
want to specify a symbol other than the default, enter it here. 





Patches no longer update the BASIC-PLUS-2 product. Now the 
compiler is updated by replacing its object modules, then linking 
them, and installing BASIC-PLUS-2 again. When you install 
updates for BASIC-PLUS-2, you must execute the BP2BLD programs 
and answer its questions again. 


If you are updating BASIC-PLUS-2, answer YES, and the BP2BLD 
dialogue asks the next question. If you answer NO or take the 
default, skip the next question. 





Enter the name of the device and account where the files from the 
update distribution medium reside. 





These files are used during the installation process and are not 
of any use after the installation, unless you want to edit them 
to further customize BASIC-PLUS-2. 
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The verification procedure executes a number of BASIC-PLUS-2 
programs to test the BASIC-PLUS-2 compiler, the RSX-11M/M-PLUS 
Task Builder, and terminal 1/0. Answer YES to verify the 
installation. 


What follows is a sample summary of options for a customized 
installation. The summary that is displayed at your terminal is 
written to the file nnnDEF.DOC as a record of the installation. 
Nnn is the three-character name you previously chose to invoke 
the BASIC-PLUS-2 compiler. 
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At this point, the BP2BLD dialogue program asks all the questions 


in the dialogue again. Note that if you selected an answer other 
than the default to a question, your answer is enclosed in angle 
brackets as the default answer for that question. 
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If you do not need to change your answers, answer NO or take the 
default answer. Then the BP2BLD dialogue responds with: 





At this point, the BP2BLD dialogue is complete. Alii your 
responses to the BP2BLD dialogue are written to the command file 
nnnDEF.CMD. You can use this command file as an indirect command 
file if you have to install BASIC-PLUS-2 again. A summary of the 
options you selected are written to nnnDEF.DOC. Nnn is the 
three-character name you previously chose to invoke the 
BASIC-PLUS-2 compiler. 


Now the installation files are executed to: 


@ Create command files to copy certain files from the 
distribution medium to the work area. 


@ link the object modules for the BASIC-PLUS-2 compiler. 


@ Install the BASIC-PLUS-2 compiler and memory-resident 
libraries, if you selected this option. 


@ Verify the installation, if you selected this option. 


During this portion of the installation procedure, new libraries 
and tasks are created and previous versions removed. At this 
time, the system may display one or more informational messages. 
The messages indicate that modules are being replaced, partitions 
are being renamed, previous versions of tasks could not be found, 
or that duplicate copies of libraries already exist. For 
example: 







Module "THREAD": replaced OS 
REM. -- Onn not: n Bye tem toe 


These messages are informational in nature and do not indicate an 
error in the installation procedure. When the installation 
procedure is complete, the system responds with: 





Table 1-1 lists the names and functions of the temporary files that 
are created or are copied from the distribution medium during the 
installation. All files except BP2DEF.CMD, BP2DEF.DOC, and BP2INS.CMD 
are deleted if you select this option in the BP2BLD dialogue. 


Some of the files listed below as beginning with the letters BP2 will 
begin with the three-character name you chose to invoke BASIC~PLUS-~2 
in the BP2BLD dialogue. This table uses the default name BP2. 


Table 1-1: Installation Files 
Sg ee A ee ee 


File Name Function 





B22S1X.CMD Is a skeleton command file for building the 
B22SH1 library, if you want to install the 
secondary cache. 


(continued on next page) 
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Table 1-1 (Cont.): Installation Files 





File Name 


a 


B22SEC.CMD 
B22SEC.MAC 


B22SH1.CMD 


B22SHR.CMD 


B22SRX.CMD 


BP211S.O0DL 


BP2BLD.CMD 
BP2BLD.TSK 
BP2CPY.CMD 
BP2DEL.CMD 
BP2ECU.CMD 


BP2ECU.ODL 


BP2EOL.CMD 


BP2EOL.ODL 


BP2EOS .CMD 


BP2E0T .OLB 


BP2ERL.CMD 





Function 


Is a command file for building the secondary 
cache, if you selected that option. 


Is a MACRO program for creating the secondary 
cache, if you selected that option. 


Is a command file for building the B22SH1 
library, if you want to install the secondary 
cache. 


Is a command file for building the B22SHR 
library, if you want to install the secondary 
cache. 


Is a skeleton command file for building the 
B22SHR library, if you want to install the 
secondary cache. 


Tells the Task Builder how to access the RMS 
libraries. 


Controls the installation process. 
Creates CMD files. 


Controls all copying of files from the 
distribution medium to the accounts you 
specified in the BP2BLD dialogue. 


Deletes temporary installation command files, if 
you selected this option. 


Links the BASIC-PLUS-2 compiler for systems with 
EIS math hardware. 


Tells the Task Builder how to overlay segments 
of the BASIC-PLUS-2 compiler while linkin 


Is created by BP2BLD.TSK, if you want to install 
the BP2RES memory-resident library for systems 
with EIS math hardware. 


Is created by BP2BLD.TSK, if you want to install 
the BP2RES memory-resident library for systems 
with EIS math hardware. 


Links the BP2SML memory-resident library for 
systems with EIS math hardware, if you selected 
this option. 


Is the BASIC-PLUS-2 object module library for 
systems with EIS math hardware. 


Builds the support for Run with the BP2RES 


memory-resident library for systems with EIS 
math hardware, if you selected this option. 


(continued on next page) 





File Name 


VN - Ow ——— 


BP2ERU.CMD 


BP2ERU.ODL 


BP2EXL.CMD 


BP 2EXL.ODL 


BP2EXS.CMD 


BP2FCU.CMD 


BP2FCU.ODL 


BP2FOL.CMD 


BP2FOL.ODL 


BP2FOS.CMD 


BP2FOT.OLB 


BP2FRL.CMD 


BP2FRL.ODL 


BP2FTR.CMD 
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Table 1-1 (Cont.): Installation Files 


Function 


Tells the Task Builder how to overlay segments 
of the support for Run while linking, if you 
selected this option. 


Builds the support for Run with the BASIC-PLUS-2 
object module library for systems with EIS math 
hardware, if you selected this option. 


Tells the Task Builder how to overlay segments 
of the support for Run while linking, if you 
selected this option. 


Is copied from the distribution medium, if you 
want to install the BP2RES memory-resident 
library for systems with EIS math hardware. 


Is copied from the distribution medium, if you 
want to install the BP2RES memory-resident 
library for systems with EIS math hardware. 


Is copied from the distribution medium, if you 
want to install the BP2SML memory-resident 
library for systems with EIS math hardware. 


Links the BASIC-PLUS-2 compiler for systems with 
FPU math hardware. 


Tells the Task Builder how to overlay segments 
of the BASIC-PLUS-2 compiler while linking. 


Is created by BP2BLD.TSK, if you want to install 
the BP2RES memory-resident library for systems 
with FPU math hardware. 


Is created by BP2BLD.TSK, if you want to install 
the BP2RES memory-resident library for systems 
with FPU math hardware. 


Links the BP2SML memory-resident library for 
systems with FPU math hardware, if you selected 
this option. 


Is the BASIC-PLUS-2 object module library for 
systems with FPU math hardware. 


Links the support for Run with the BP2RES 
memory-resident library for systems with FPU 
math hardware, if you selected this option. 


Tells the Task Builder how to overlay segments 
of the support for Run while linking, if you 
selected this option. 


Modifies the object modules to support the 


EDIT$, TIMES, and DATES options, if you selected 
these options. 
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Table 1-1 (Cont.): Installation Files 


i RR 


File Name Function 


ea i a 


BP2FTR.ULB Contains the object modules to support the 
EDITS, TIMES, and DATES options, if you selected 
these options. 


BP2FRU.CMD Links the support for Run with the BASIC-PLUS-2 
object module library for systems with FPU math 
hardware. 


BP2FRU.ODL Tells the Task Builder how to overlay segments 
of the support for Run while linking, if you 


selected this option. 


BP2FXL.CMD Is copied from the distribution medium, if you 
want to install the BP2RES memory-resident 
library for systems with FPU math hardware. 


BP2FXL.ODL Is copied from the distribution medium, if you 
want to install the BP2RES memory-resident 
library for systems with FPU math hardware. 


BP2FXS.ODL Is copied from the distribution medium, if you 
want to install the BP2RES memory-resident 
library for systems with FPU math hardware. 


BP2INS.CMD Installs BASIC-PLUS~-2 task images and 
memory-resident libraries, if you selected these 
options. 

BP2RN1.CMD Renames files created during the installation. 

BP2RN2.CMD Renames files created during the installation. 

BP2RSQ.CMD Links the BASIC-PLUS-2 Resequencer, if you 
selected this option. 

BP2RSQ.ODL Tells the Task Builder how to overlay segments 
of the BASIC-PLUS-2 Resequencer while linking. 

BP2RSX.CMD Copies the installation command files and 
executes BP2BLD-CMD. 

BP2VEO.CMD Verifies the installation, if you selected this 
option. 

BP2VE1.CMD Verifies the installation, if you selected this 
option. 

DIALOG. DAT Contains the dialogue text. 

DIALOG. TSK Executes the dialogue. 

GLBADD.CMD Is copied from the distribution medium, if you 
want to install the secondary cache. 

RSXCFELIB.OLB Is the compiler front-end library. 

RSXLIB.OLB Is the support for the compiler. 
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Table 1-1 (Cont.): Installation Files 








File Name Function 
ce es ee ee 


THREAD. DAT Contains data required by THREAD.TSK. 

THREAD .TSK Creates a file of definitions for the addresses 
of the routines to support Run. 

THREAD .MAC Is the file of definitions THREAD.TSK creates. 

THREAD .OBJ Is the object module created by assembling 
THREAD .MAC. 


eee 


1.4.2 The Verification Test 


BP2BLD runs a verification test that checks the BASIC-PLUS-2 compiler 
and Task Builder. If the verification test is successful, the 
following output is displayed: 








PDP-1i' akcen ace : 


BASIC2_ 





@SY:BP2VEO 

NEW SY:BP2T0. ; 

10 DECLARE INTEGER I 

20 DECLARE STRING J 

30 PRINT 'BASIC-PLUS-2 INSTALLATION VERIFICATION’ oo. 
40 FOR I = 1 TO 10 . = 


50° | J = SPACE$(I) + NOMS (2) 
GO. So SPRENDT. 
70... NEXT. To 


80.» PRINT, ‘VERIFICATION 1 as “COMPLETE 
90. PRINT ERTS.L08)" 
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If the verification was not successful, the Soe does not ai nis 
the output. In this case, check to make sure the following software 
is installed: 

e RMS-11 

e The BASIC-PLUS-2 compiler 


e The BASIC-PLUS-2 memory-resident library (or libraries), if 
you selected this option 


If the software listed above is installed and the verification test is 
not successful, contact your DIGITAL software specialist. 


1.5 DISMOUNTING THE DISTRIBUTION MEDIUM 


After the installation dismount the distribution medium 


by: 





1. Issuing the DCL DISMOUNT command or the MCR DMO command, if 
you used the MOUNT command 


2. Unloading the drive and then removing the distribution medium 
The format of the DISMOUNT command is: 

DCL MCR 

DISMOUNT ddnn: [BP2V2] DMO ddnn: [BP2Vv2] 


where 





@dnn: Is the name and number of the device on which your 
distribution medium is physically mounted. 


BP2V2 Is the label. Specify the label if you used it to 
mount disk distribution. 


Consult your drive's operation manual for information on how to unload 


the drive and remove the distribution medium. Store the distribution 
medium with a record of the installation. 
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CHAPTER 2 


EDITING THE BASIC-PLUS-2 HELP FILE 


If you decided to install the BASIC-PLUS-2 HELP file, you may also 


; A ; : 
nodify the information in it or add new information to it. 


rm 


To modify the information in the HELP file, use a text editor to edit 
the file BP2.HLP. Search for the topic you want to change and then 
make your edits. 

To add new information in the HELP file, you must: 


1. Use a text editor to edit the file BP2.HLP. 


2. Enter the new information in the format: 


n Topic 
text 
Format 

syntax 
Example 
example 
where: 

n Is the level of specificity. You must 
specify a level in the range 1 to 9. The 
more general the topic, the lower the 
number. For example, STATEMENTS is a level 
1, ON is a level 2, and ON GOTO is a_ level 
3. 

Topic Is a BASIC-PLUS-2 language element. You 
must specify a topic. 

text Is an explanation of the topic. The text 
is optional. 

Format Is the title for the next piece of 
information. The title is optional. 

syntax Is the syntax for the language element. 


See the BASIC Reference Manual for the 


syntax fo) all BASIC-PLUS-2 language 
elements. The syntax is optional. 


EDITING THE BASIC-PLUS-2 HELP FILE 
Example Is the title for the next Piece of 
information. The title is optional. 


example Is an example of the language element. The 
example is optional. 


Here is an example of the HELP format: 
2 ASCII 


The ASCII function returns the decimal ASCII value of a 
string's first character. 


Format 
{asc} 
int-vbl = {ASCII} (str-exp) 
Example 
10 ASCII_VALUE% = ASCII (EMPLOYEE NAMES) 


Close and save the edited version of BP2.HLP. 
Run the BP2RFA utility. 


The BP2RFA utility takes the Record File Address (RFA) of the 
start of each HELP topic and places it in a file. When you 
ask for help on a particular topic, BASIC-PLUS-2 searches 
this file first to speed access to HELP information. 


Mount the distribution medium and copy BP2RFA.TSK from it. 
See Section 1.3 for information on mounting the distribution 
medium. If your distribution medium is magnetic tape and 
your system is RSX-11M-PLUS, copy BP2RFA.TSK by typing: 

FLX /RS/CO/BL:142/IM=ddnn:[1, 10]BP2RFA.TSK/-RW/DO 


If your distribution medium is magnetic tape and your system 
is RSX-11M, copy BP2RFA.TSK by typing: 


FLX /RS/CO/BL:142/FB=ddnn: [1,10 ]BP2RFA.TSK/-RW/DO 


If your distribution medium is a_ disk, copy BP2RFA.TSK by 
typing: 


PIP /NV/CO=ddnn:[1, 10]BP2RFA.TSK 
where: 


ddnn: Is the name and number of the device on which 
the distribution medium is physically mounted. 


After you copy BP2RFA.TSK from the distribution medium, you 
can run the utility by typing: 


RUN BP2RFA 
The utility asks you: 
Enter the device and account of help file: ? 
Specify the device and account where BP2.HLP is located. 


Then the utility generates a new version of BP2RFA-.HLP and 
places it in the device and account you specified. 


CHAPTER 3 


SETTING COMPILER DEFAULTS AFTER THE INSTALLATION 


The BASIC-PLUS-2 installation procedure provides default values for 
many compiler commands and qualifiers. For example, the default 
integer size is WORD and the default real size is SINGLE. However, 
depending on the type of programs you write, these defaults might not 
be the most efficient for the users on your system. 


To solve this problem, BASIC provides a method for customizing the 
compiler defaults at any time after the installation. In fact, you 
can change the defaults to suit your programming needs, whenever 
necessary. 


3.1 THE SYSTEM INITIALIZATION FILE 


The following example output from the SHOW command illustrates the 
compiler defaults as defined by the installation: 


PDP-1l BASIC-PLUS-2 V2.2-00 using FPU with run support 
ENVIRONMENT INFORMATION: RMS FILE ORGANIZATION: 
Current edit line : 0 NO Index 
NO Modules loaded NO Relative 
NO Main module loaded NO Sequential 
NO Virtual 
DEFAULT DATA TYPE INFORMATION: LISTING FILE INFORMATION: 
Data type : REAL NO Source 
Real size : SINGLE NO Cross Reference 
Integer size : WORD NO Keywords 
Scale factor : 0 60 lines by 132 columns 
COMPILATION QUALIFIERS: BUILD QUALIFIERS: 
Ob ject NO Dump 
NO Macro NO Map 
Lines NO Cluster 
Warnings Task extend : 512 
NO Debug records RMS ODL file : LB:[1,1]RMS11X 
NO Syntax checking BP2 Disk lib : LB:[{1,1]BP20TS 
Flag : Declining BP2 Resident lib : NONE 
Variant : 0 RMS Resident lib : NONE 


You can change these compiler defaults by creating a BASIC 
initialization file in the system account LB:[1,2]. The BASIC system 
initialization file is a file containing a subset of BASIC compiler 
commands that the BASIC-PLUS-2 compiler executes any time a user 
enters the BASIC environment. The new defaults you set in the system 
initialization file affect all users on the system. 


To create a system initialization file, use a text editor to create a 
file named BP2INI-nnn in the account LB:[1,2] (where nnn is the three- 
character name you chose to invoke BASIC with). Table 3-1 lists the 


SETTING COMPILER DEFAULTS AFTER THE INSTALLATION 


BASIC commands you can include in the initialization file. For a 
complete description of these commands, see the BASIC on 
RSX-11M/M-PLUS Systems manual. 


Table 3-1: BASIC Commands allowed in an Initialization File 





Command Function 
a a 

BRLRES Specifies the default BASIC-PLUS-2 memory-resident 
library 

DSKLIB Specifies the default BASIC-PLUS-2 object module 
library 

LIBRARY Specifies the default BASIC-PLUS-2 memory-resident 
library ; 

LOCK ‘Sets qualifiers to the COMPILE or BUILD command 

ODLRMS Specifies the default RMS ODL file 

RMSRES Specifies the default RMS memory-resident library 

SCALE Sets the scale factor 

SET Sets qualifiers to the COMPILE or BUILD command 

SHOW Displays the current defaults 





Each command must appear on a separate line of the initialization 
file. Comments are not allowed; however, you can include blank lines 
to improve readability. 


Compiler commands within a BP2INI file function the same as commands 
entered from the terminal, with the exception that commands that 
normally prompt for library names must have library names supplied in 
the command line. For example, if the command DSKLIB appears in the 
initialization file without a library specification following it, the 
compiler displays the error message: 


no file specified for a command initialization file 
The following is an example of an initialization file: 
SET /LIST 
SET /DOUBLE/LONG 
SCALE 4 
SHOW 
This BP2INI.BP2 file changes the default compiler environment so that: 


@ The COMPILE command produces a source listing. 


® The default size for all floating-point data is DOUBLE, and 
the default size for all integers is LONG. 


@ The scale factor is 4. 


e The compiler displays a list of the new default compiler 
settings. 
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Note that the compiler does not display the initialization file as it 
is processed. Thus users do not know whether an initialization file 
is being processed unless an error occurs in that file. You may want 
to include the SHOW command in the file to notify users of what the 
resent defaults are 


D 
LY ae J we 


If you do include the SHOW command, make sure it is the last command 
in the file. If not, the defaults the SHOW command displays can be 
misleading: they do not reflect the changes produced by commands that 
follow SHOW in the initialization file. 


3.1.1 Private Initialization Files 


The system initialization file affects all BASIC users on your system. 
Individual users can also set the compiler defaults for their own use 
with a private initialization file. Private initialization files 
follow the same rules as the system initialization file and have the 
same file name, but they are in the individual user's default account. 


Note that the BASIC compiler performs the commands in the system 
initialization file first and then performs the initialization file in 
the user's default account. This way the user can override any 
system-wide defaults set by the system initialization file because the 
commands in his or her private file are performed last. 


See the BASIC on RSX-11M/M-PLUS Systems manual for more information on 
private initialization files. 





CHAPTER 4 


RELEASE NOTES 


Included on the distribution medium for BASIC-PLUS-2, is a file 
describing new features introduced in Version 2.2 and known problems. 


wOlLiviil alien 


These release notes are in the file [1,10]RELNOT.DOC. 


To read the release notes, mount the distribution medium (as described 
in Section 1.3) and copy the file [1,10]RELNOT.DOC from the 
distribution medium to your default account; or you can copy the file 
directly to a line printer if you want a hard copy of the release 


notes. 


APPENDIX A 


SAMPLE INSTALLATION 


This is a sample BASIC-PLUS 


ved sratan Nata tat 
operating syscem. NOCS CHat 


2 installation on an RSX-11M-PLUS 
hea . 

i 

different from this sample. 


. sy, 
Lu 


@€ output your system generates may be 


SAMPLE INSTALLATION 


PALL DKIS 

>HOU DRI: BP2V2 

>FLX SY{/RS=DKL{£C1,10]BP2RSX.CMD/DO 

>@BP2RSX 

>k What device is the distribution disk mounted on <DLOi> (S12: DK1: 


BASTC -PLUS -2 
VERSION 2 INSTALLATION 


This starts the BP2EBLD dizlosue. The BP2BLD dizlosue asks you 
questions $0 you can select the options for your BASIC~PLUS-2 
compiler. The default answer for each auestion is in ansle 
brackets. To select the default» rress the RETURN key. If 
you do not want the default answer? tyre in the answer you want. 


You should read the BASIC-FLUS-2 installation sduide before you 


begin the BF2ELD dialogue, Some of the answers you select 
can result in additional auestions or the omission of certain 
auestions later in the dialogue, If vou are mot sure how to 


answer 3a auestions vou can either tyre a auestion mark (7) for a 
brief exrlanation or see the BASIC~-PLUS-2 installation guide for 
more information: 


The EP?BLI rrogram rrints a summary of your answers at the end 
of the dialogue. If you want to chanse your answerss answer YES 
to the auestion at the end of the summary, at this point, the 
BP2BLD rrosgram runs the BP2BLD disloduve again. If you choose an 
ortion other than the default, your choice is enclosed in angle 
brackets as the default answer for that auestion, 

If you want to change an answer during the dislogue but before 
the summary, tyre the escare key (<ESCe) to back up ta the 
answer you want to change and then tyre the correct answer: 


Do vou want the default installation <YES> 


?NO 


Do vou want to instell BPSRES <NO> 


?YES 


Enter the device and account for BP2RES <LBiCiyi1I> 


PLEiCisid 


What is the rartition mame for BF2RES <GEN> 


GEN 


To you want to install BP2SML =NO> 


?YES 


Enter the device and account for BF2SML <LBiCL1i:11> 


PLES C1s1] 


SAMPLE INSTALLATION 


What is the eartition name for BF2SML <GEN> 


?GEN 


io you want to install the secondary cache <NO> 


?YES 


What size do vou want to make the secondary cache <8> 


P12 


= 


Enter the device and account for B22SHR <LBiCir1i1> 


PLEiCir1] 


What is the rartition name for B22SHR <GEN> 


?GEN 


Enter the device and account for B22SH1 <LBiCisi43> 


PLBiC1+s1) 


Whet is the rartition name for B22SH1 <GEN> 


?GEN 


To you want to surprort RUN <YES> 


PYES 


To vou want RUN to surrort remote RMS file access <NO> 


?YES 


Tio you want to link the surrort for RUN with memory resident libraries <YES> 


TYES 


To vou want to install the BP2 Reseavencer <NO> 


?NG 


flo you want to install the BP2 Hele file <NO> 


?NO 


Which hardware math rackade do vou want to use <EIS* 


?EIS 


SAMPLE INSTALLATION 


What name do vou want to use to invoke BP2 <BP2> 


PVDF 


What do vou want to use as the BP2 comriler 


?T22E1S 


eromrpt <BASIC2> 


Enter the device and account for the BF2 comriler <LBiC1:54]> 


PLBiC1:54)] 


Enter the device and account for the BP2 compiler work files <SYi> 


Psy: 


Enter the device and account for the BF2 obJect module disk library <LBiCir11> 


PLES C11] 


Enter the device and account for the BF2 ODL files <LBiCisid> 


PLES C11] 


Enter the device and account for the temp installation files <SYi> 


?Sy3 


Enter the device and account for the RMS-il 


PLBSCirid 


To vou want the EDIT$ urpcase (function code 
in the renge (octal 173 - 1746) <NO> 


?NO 


Wheat do you want as the default time format 


PAM/PRM 


OBL files <LEiCiriid> 


32) to arrly to characters 


AAM/P MS 


What do vou want as the cheracter for the PRINT USING currency symbol <> 


What do you want as the character for the FRINT USING decimal foint <,2 


= 
4 


What do vou want as the character for tne PRINT USING third digit 


serarator <> 


SAMPLE INSTALLATION 


To you want to update the BP2 compiler <NO> 


PNO 


To vou want to delete the installation command files <YES> 


PYES 


To vou want to verify the installation <YES> 


?YES 
Here is 2 summary of the options vou have selected? 


This is not @ defauit instaliistiion 

BF2RES will be installed 

Tne device and account for BP2RES is LBtCi:1] 

The rartition name for BP2RES is GEN 

BP2SML will be installed 

The device and account for BP2SHL is LBifCisi] 

The Partition name for BP2SML is GEN 

Secondary caching will be enabled 

The size of the secondary cache will be 12 

The device and account for B22SHR is LBiC1l?id 

The partition name for B22SHR is GEN 

The device and account for B22SH1 is LBifis?i] 

The partition name for B22SH1 is GEN 

RUN will be surrorted 

RUN will supfort remote RMS file access 

RUN surrort will be linked with memory resident libraries 
The BP2 Reseauencer will not be installed 

The BF2 HELP file will not be installed 

The hardware math package is EIS 

Tne mame to use to invoke BF2 is VDP 

The BP2 comriler rromept is T22E1S 

The device and account for the BP2 compiler is LBiC1*54] 
The device and account for the BP2 compiler work files is SY? 
The device and account for the BP? object module disk library is LEBiCi:i] 
The device and account for the BP2 ODL files is LBiCi,1] 
The device and account for the temr installation files is SY? 
The device and account for the RMS-11 ODL files is LEtE£1:1] 
EDITS will mot urcase characters (octal 173 - 176) 

The default time format is AM/FM 

The FRINT USING currency symbol is $ 

The PRINT USING decimal roint symbol is . 

The PRINT USING third digit serarator symbol is » 

The BP2 comeiler will not be uedated 

The installation command files will be deleted 

The compiler installation will be verified 


Do you wish to change any of your answers <NQO> 


? NO 

The BP2BLI dialogue is complete. 

The installation will take about 1 hour to comrlete. 
Module "THREAD" rerleced 

The BASIC-PLUS~-2 installation is complete, 

PDF-11 BASIC-PLUS-2 T2,2-00 


T22E1S 


SAMPLE INSTALLATION 


@SYSVDFVEO 

NEW SYS BF2TO 

10 DECLARE INTEGER I 

20 DECLARE STRING J 

30 FRINT ‘BASIC-PLUS-2 INSTALLATION VERIFICATION’ 
40 FOR I = 1 TO 190 

30 J = SPACES(I) + NUMIS$(T) 
60 PRINT J 

70 NEXT f 

Bo PRINT ‘VERIFICATION #1 COMPLETE’ 
90 FRINT ERTS(O%) 

100 END 


REPLACE SY? BP2TO 
COMPILE SYi/0BJ 


BF2TO 03:14 FM 17-Feb-84 
BUILD SY: 
EXIT 


RASIC-FLUS-2 INSTALLATION VERIFICATION 

1 

2 

3 
4 
5 
& 
7 
8 
9 
10 

VERIFICATION #1 COMPLETE 
BASIC FPLUS-2 


POP-11 BASIC-FLUS-2 T2,2-00 
T22E1S 


@SYIVDFVEL 

OLD SY!BF2TO 

80 PRINT ‘VERIFICATION #2 COMPLETE’ 
RENAME SY!BP2T1 

REPLACE SY{BP2T1L 

COMPILE SY3/OBJ 


BR2T1L 03:14 PM 17-Feb-84 
BUILD S¥? 
EXIT 


BASIC-FLUS-2 INSTALLATION VERIFICATION 
1 


10 
VERIFICATION #2 COMPLETE 
BASIC FPLUS~2 


OMO -- VT13 dismounted from DKit KX Final dismount initiated Kxx 
DEA -- Tevice mounted 
>@ <EOF> 


BASIC-PLUS-2 RSX-11M/M-PLUS 
Installation Guide and Release Notes 
AA-0158F-TC 
READER’S COMMENTS 
NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 


company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 


























Did you find errors in this manual? If so, specify the error and the page number. 
































Please indicate the type of user/reader that you most nearly represent. 

















[|] Assembly language programmer 
(] Higher-level language programmer 
(1) Occasional programmer (experienced) 
(CO User with little programming experience 
(} Student programmer 
{] Other (please specify) 
Name Date 
Organization 
Street 
City State _________ Zip Code 





or Country 
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